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1.   INTRODUCTION 

Computer  systems  are  often  difficult  and  awkward  to  use.   This 
is  no  less  true  of  data  management  systems  (DMS) ,  which  are  designed  for 
use  largely  by  non-computer  scientists.   Problems  typically  encountered 
by  DMS  users  include:   awkward  command  syntax;  communication  through 
artificial  jargon;  the  need  to  go  through  one  or  more  computer  professionals 
for  help  in  formulating  a  request;  confusing  error  messages;  and  slow 
response  time.   Problems  such  as  these  are  sufficiently  common  that  many 
computer  users  simply  learn  to  tolerate  them  rather  than  insisting  on 
more  usable  human  interfaces. 

This  thesis  documents  one  attempt  at  an  improved  interface. 
An  intelligent  terminal  was  built  to  act  as  a  front-end  to  an  existing 
data  management  system.   This  terminal  system  approached  several  of  the 
problems  mentioned  above.   It  attempted  to  give  the  user  rapid  response 
or  explanatory  messages  when  the  response  time  was  slow.   It  attempted 
to  eliminate  the  confusion  resulting  from  artificially  imposed  computer 
jargon  by  tailoring  the  front-end  system  to  one  particular  application 
and  by  using  the  language  of  that  application.   Also,  user  hand-holding 
and  feedback  was  built  into  the  system  to  minimize  training  required  to 
use  the  terminal. 

The  completed  system  was  demonstrated  to  both  system  programmers 
and  DMS  users.   The  response  was  very  favorable.   The  observers  not  only 
were  impressed  with  the  ease  of  use  of  the  demonstration  DMS,  but  also 
were  interested  in  seeing  what  further  extensions  of  these  ideas  might 
accomplish. 


2.   PROBLEMS  ADDRESSED 

The  primary  thrust  of  this  project  was  to  create  a  better 
human  interface  to  an  operational  interactive  data  management  system. 
The  use  of  an  interactive  system  can  in  itself  minimize  some  of  the 
problems  mentioned  above,  e.g.  excessively  long  response  times.   However 
many  other  problems  remain  to  be  approached  by  the  terminal  front-end 
system. 

The  problems  addressed  by  the  terminal  system  fall  into  three 
general  areas: 

1.  the  language  of  the  system, 

2.  the  method  of  input,  and 

3.  reliability. 

System  language.   Data  management  systems  tend  to  be  general 
in  design,  so  that  different  applications  can  use  the  same  DMS .   Although 
this  generality  may  make  the  DMS  more  widely  applicable,  it  can  make  any 
specific  user's  job  more  difficult.   The  user,  already  familiar  with  the 
jargon  of  a  specific  application,  is  forced  to  learn  a  new,  relatively 
artificial,  machine-oriented  jargon  in  order  to  communicate  with  the 
DMS.   This  learning  process  may  require  a  training  period  of  weeks  or 
months.   Then,  since  the  language  is  artificial  to  the  user,  facility 
with  the  DMS  can  be  quickly  lost  if  the  user  does  not  have  frequent 
contact  with  the  system.   Once  familiarity  is  lost,  the  user  will  tend 
to  make  more  syntactical  mistakes.   Often  the  resulting  error  messages 
are  not  particularily  helpful,  and  may  cause  increased  frustration  and 
confusion  for  the  user. 
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Input  mechanism.   Most  computer  terminals  use  some  type  of 
keyboard-like  mechanism  for  user  input.   For  non-typists  and  inexperienced 
users  in  general,  this  in  itself  can  be  a  slow,  awkward,  and  particularly 
frustrating  procedure. 

Reliability.   Under  ordinary  circumstances,  a  user  must  rely 
on  the  availabity  of  a  host  computer  in  order  to  retrieve  information 
from  a  data  base.   This  presents  three  types  of  problems.   First,  processing 
time  on  the  host  may  be  quite  expensive.   Second,  communication  facilities 
between  the  terminal  and  the  host  may  be  slow  or  expensive  or  both.   And 
third,  if  the  host  is  unavailable  either  because  the  computer  itself  is 
down  or  because  the  communication  facility  is  down,  the  user  is  unable 
to  get  any  information  from  the  data  base. 

The  combination  of  these  three  aspects  of  most  data  management 
systems  can  make  these  systems  very  frustrating  to  many  users. 


3.   PHILOSOPHY  OF  SOLUTIONS 

Before  describing  the  specific  system  which  was  built,  a 
discussion  of  the  general  types  of  solutions  used  is  in  order.   The 
final  approach  was  based  on  five  primary  considerations: 

1.  The  system  must  not  require  any  modifications  to  the 
existing  DMS. 

2.  A  more  easily  usable  command  syntax  and  input  mechanism 
than  is  currently  available  was  desired. 

3.  The  local  processing  and  memory  capabilities  of  the  terminal 
should  be  used  to  maximize  the  user  feedback  and  to  minimize 
the  load  on  the  remote  host. 

4.  The  front-end  system  should  be  able  to  survive  host  system 
crashes. 

5.  The  solution  had  to  be  feasible  under  currently  available 
technology. 

DMS  interface.   Since  the  DMS  front-end  could  not  make  any 
changes  in  the  host  system,  the  terminal  was  designed  to  interact  with 
the  DMS  as  a  normal  user.   Communication  with  the  DMS  would  use  the 
standard  human  conventions  for  that  system  and  would  be  generated  by  the 
front-end.   DMS  output  would  be  formatted  by  the  front-end  for  communication 
with  the  user. 

Ease  of  communication.   The  second  consideration  was  approached 
from  three  different  directions.   First,  the  front-end  was  custom  tailored 
to  one  particular  application.   This  allows  the  creation  of  a  syntax  in 
a  familiar  jargon  which  is  more  meaningful  to  the  user  than  the  general 
purpose  approach  of  the  DMS.   The  second  angle  of  attack  was  to  use  this 


jargon  in  presenting  the  user  with  a  menu  of  all  possible  choices  at 
every  step  of  a  command.   This  relieves  the  user  of  the  need  to  memorize 
the  syntactical  form  of  commands,  and  so  decreases  the  amount  of  training 
required  to  use  the  system.   Finally  a  touch  panel  rather  than  a  keyboard 
was  used  as  the  primary  form  of  user  input.   Using  this  panel,  a  command 
is  selected  by  touching  "buttons"  which  are  displayed  on  the  terminal 
screen.   These  buttons  present  all  the  valid  options  at  every  step.   The 
need  to  remember  syntactical  forms  and  the  need  to  type  are  both  eliminated , 
Specifying  a  command  becomes  simply  a  matter  of  selecting  a  series  of 
buttons  on  the  screen.   Additionally,  this  approach  eliminates  for  the 
user  the  frustration  of  making  syntactical  mistakes,  since  they  are 
impossible. 

Local  capabilities.   The  local  memory  and  processing  capabilities 
of  the  terminal  are  utilized  in  many  ways.   Primarily  they  serve  as  a 
local  cache  for  data  items  and  handle  most  of  the  user  interaction  with 
the  system.   As  each  data  item  is  retrieved  from  the  host  for  display, 
the  item  is  also  stored  in  local  memory.   When  that  item  is  requested 
later,  it  is  available  without  accessing  the  host.   This  cache  technique 
reduces  the  use  of  the  communication  facility  and  the  load  on  the  host. 
The  local  processing  power  is  used  to  manage  the  cache,  to  create  all 
displays  of  data  items,  to  handle  the  menu  selection  described  above, 
and  to  provide  feedback  to  the  user  as  to  what  the  system  is  doing.   The 
local  generation  of  displays  not  only  allows  for  the  displays  to  appear 
quickly,  but  also  for  an  item  to  be  quickly  redisplayed  in  a  different 
format.   This  saves  processing  time  on  the  host  and  reduces  the  load  on 
the  communication  facility.   Also,  the  local  processing  power  allows 
quick  feedback,  e.g.  indicating  which  button  was  touched  or  displaying 
messages  about  the  state  of  an  attempted  item  retrieval. 
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Survivability.   The  existence  of  a  mini-computer  in  the  terminal 

allows  the  front-end  terminal  system  to  proceed  when  the  host  is  unavailable. 

When  the  host  is  down,  the  user  may  have  a  limited  set  of  available 

commands,  such  as  being  able  to  display  only  data  items  which  are  in  the 

terminal.   Within  these  restrictions,  the  user  can  continue  to  work 

without  the  main  host  system. 

Technology.   The  terminal  was  built  from  commercially  available 
hardware  and  required  no  modifications  to  that  hardware. 

In  addition  to  the  stated  front-end  system  goals,  the  approach 
used  has  two  other  advantages.   First,  the  compound  system  of  intelligent 
terminal  and  DMS  appears  more  reliable  to  the  user  than  the  DMS  alone. 
The  terminal  crashes  less  frequently  than  the  large  system.   It  is  a 
basically  simpler  device  with  fewer  components,  connectors,  etc.   In 
addition,  it  can  mask  a  host  crash.   As  a  result,  the  amount  of  time  the 
system  is  unavailable  to  the  user  is  decreased  by  using  the  intelligent 
terminal.   Second,  the  compound  system  can  actually  be  cheaper  to  operate 
than  using  a  standard  terminal  to  access  the  DMS.   Initially  the  intelligent 
terminal  itself  is  more  expensive  than  a  standard  terminal.   However, 
the  intelligent  terminal  reduces  the  load  on  the  host  computer  by  decreasing 
the  number  of  item  retrievals  done  and  by  doing  all  display  generation. 
The  money  saved  by  reducing  the  amount  of  time  purchased  on  the  remote 
host  can  make  up  for  the  extra  cost  of  the  smarter  terminal.   (See  [3] 
for  a  discussion  of  a  similar  mechanism  studied  at  Harvard  University.) 


IMPLEMENTATION  APPROACH 


A  system  was  built  in  order  to  test  the  theories  outlined  in 
Chapter  3.  It  was  intended  merely  as  a  demonstration  vehicle  to  study 
those  philosophies  and  to  get  feedback  from  users  on  what  was  good,  on 
what  was  not  so  good,  and  on  possible  further  improvements.  In  no  way 
was  this  system  intended  to  be  anything  other  than  experimental. 

The  discussion  of  this  DMS  front-end  system  will  include 
descriptions  of  the  hardware  comprising  the  terminal  itself,  the  user 
input  mechanism,  the  data  bases  used,  and  the  terminal  actions  from  the 
user's  point  of  view.   Alter  this  overview  has  been  given,  the  front-end 
system  will  be  explained  in  more  detail. 

Terminal  hardware.   The  terminal  itself  consisted  of  a  Digital 
Equipment  Corporation  PDP-11/ 10  with  20K  words  of  memory,  a  high  speed  plasma 
panel,  a  touch  panel,  and  a  modem  for  phone  line  communication  (figure  1). 
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Figure  1 
Intelligent  Terminal  Hardware 


Also  in  the  terminal,  but  of  little  logical  importance,  were  a  DECtape 
drive  and  a  keyboard.   The  tape  drive  was  only  used  for  initially  loading 
the  system  software  into  the  PDP-11,  and  the  keyboard  was  used  only  to 
log  in  to  the  remote  host. 

The  plasma  panel  used  is  roughly  similar  to  a  CRT  but  has  a 
flat  screen  and  presents  a  flicker-free  display  [1].   The  high  speed 
parallel  panel  differs  from  a  standard  plasma  panel  in  that  a  mask  of 
sixteen  dots  can  be  written  in  one  panel  access.   The  high  speed  of  this 
screen  allows  some  feedback  mechanisms  which  would  not  be  effective  on  a 
slower  device. 

The  touch  panel  consists  of  a  square  frame  which  fits  on  the 
front  of  the  plasma  panel,  like  a  picture  frame.   The  touch  panel  uses 
light  emitting  diodes  and  light  sensing  phototransistors  to  create  a 
grid  of  infrared  light  beams  approximately  one  quarter  inch  in  front  of 
the  screen.  As  a  pair  of  intersecting  beams  are  broken,  the  panel 
coordinates  of  the  touch  can  be  read,  similar  to  ordinary  input  devices. 

Buttons.   When  user  input  is  needed,  rectangles  labeled  with 
the  possible  choices  are  displayed  on  the  screen.  These  rectangles  or 
"buttons"  are  positioned  to  be  directly  behind  one  or  more  touch  inter- 
sections.  If  the  user  touches  the  screen  where  a  button  is  displayed, 
the  corresponding  touch  beams  in  front  of  the  screen  will  be  broken. 
This  will  allow  the  terminal  software  to  ascertain  which  button  was 
touched.   Thus  the  primary  form  of  input  consists  of  touching  a  series 
of  programatically  displayed  buttons. 

Data  Base.   The  terminal  front  end  system  allows  access  to  a 
subset  of  a  data  base  currently  existing  on  the  MIT  Multics  system. 
This  data  base  contains  the  Illinois  Socio-Economic  Indicators  for  Rural 
Development.   It  resides  in  the  Janus  DMS  which  is  a  subsystem  of  the 


Consistent  System.   The  Consistent  System  is  a  large  general  purpose 
data  management  and  analysis  system  [2].   A  subset  rather  than  the 
entire  data  base  was  used  for  the  demonstration  system  to  eliminate  some 
problems  which  seemed  extraneous  to  the  topics  being  studied.   For 
example,  the  number  and  size  of  data  items  were  limited  so  that  all 
displays  could  fit  on  one  screen,  and  so  that  the  amount  of  local  storage 
required  would  not  be  excessive. 

The  data  base  subset  used  for  the  demonstration  contained 
thirty  data  bases:   one  containing  information  on  the  northern  twenty- 
nine  counties  of  Illinois  and  one  for  each  of  these  counties,  containing 
more  detailed  information.   The  elements  of  the  Illinois  data  base  refer 
to  counties.   The  elements  of  each  county  data  base  refer  to  towrr=  with 
populations  of  greater  than  2500. 

Each  of  the  data  bases  is  essentially  a  matrix  of  information. 
The  rows  of  the  matrix  contain  information  about  a  specific  county  or 
town  in  the  data  base.   The  columns  contain  information  about  a  specific 
attribute  of  each  county  or  town.   The  information  in  the  data  base  can 
be  referenced  by  column.   These  column  vectors  are  referred  to  as  "items." 
An  item  of  information  contains  all  the  values  of  a  specific  attribute, 
such  as  population,  of  the  counties  or  towns  in  the  data  base.   In 
keeping  with  the  space  limitations  mentioned  above,  the  Illinois  data 
base  was  restricted  to  twenty-nine  items  for  each  of  twenty-nine  counties. 
The  county  data  bases  were  restricted  to  seventeen  items  for  up  to  five 
towns . 

The  local  memory  in  the  terminal  was  managed  so  that  up  to 
sixteen  Illinois  data  items  and  one  entire  county  data  base  can  be 
resident  in  the  terminal  at  once. 
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Front-end  system.   The  primary  function  performed  by  the 
terminal  system  is  to  display  data  items.   To  see  an  item,  the  user  must 
specify  the  data  base  of  interest,  the  item  within  that  data  base  which 
is  to  be  displayed,  and  the  format  of  the  display.   At  this  point,  the 
front-end  system  will  formulate  the  request  to  the  host  for  the  retrieval 
of  the  data  item.   The  retrieved  item  values  are  converted  into  the 
local  format  and  stored  in  the  cache  memory.   Finally  the  item  is  displayed 
in  the  indicated  format.   If  the  requested  item  was  already  resident  in 
the  terminal,  the  local  copy  is  used  for  the  display.   In  addition  to 
retrieving  and  displaying  data,  the  terminal  system  also  provides  extra 
facilities  such  as  printing  an  explanatory  paragraph  about  any  command 
with  which  the  user  needs  help.   This  system  does  not  provide  any  facility 
for  creating  or  updating  data  items.   It  will,  of  course,  continue 
running  if  the  remote  host  goes  down. 
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5.   EXTERNAL  SYSTEM  VIEW 

A  general  understanding  of  the  front-end  system  can  be  gained 
by  observing  the  terminal  actions  from  the  point  of  view  of  the  user. 
Basically  the  user  is  presented  with  successive  screens  or  "pages"  of 
buttons.   Each  page  asks  the  user  to  specify  which  of  the  valid  options 
is  desired.   After  all  necessary  options  have  been  specified,  the  requested 
command  is  executed. 

Each  page  of  buttons  specifying  options  of  a  command  has 
special  "Proceed"  and  "Cancel"  buttons.   After  the  desired  options  have 
been  selected,  the  user  must  touch  the  Proceed  button  before  execution 
will  continue.   This  allows  the  user  to  correct  extraneous  touches  and 
to  verify  that  the  desired  options  have  been  selected  before  continuing. 
If  at  any  time  the  user  wishes  to  abort  a  command,  touching  the  Cancel 
button  will  return  the  system  to  the  front  page  of  buttons. 

The  front  page  (figure  2)  presents  five  commands: 

1.  Help, 

2.  Select  Data  Base, 

3.  Display  Data, 

4.  Manual  Override,  and 

5.  Halt. 

When  the  user  selects  one  of  these  commands,  the  front  page  is  replaced 
by  other  pages  presenting  options  relevant  to  the  selected  command. 
These  five  commands  are  explained  more  fully  below. 

5.1  Help 

The  user  is  presented  with  a  page  containing  a  button  for  each 
command  (figure  3) .   The  user  touches  the  button  for  the  command  which 
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Figure  2 
Front  Page 
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which  command  do  you  want  Help' 


Cance 1 


Proceed 


Figure  3 
Help  Page 

needs  explanation.   A  paragraph  is  displayed  which  describes  the  function 

and  use  of  the  indicated  command.  Due  to  local  memory  space  restrictions, 

these  paragraphs  are  stored  on  the  remote  host.   Thus,  no  help  is  available 

if  the  host  is  down.   In  that  case  the  Help  button  does  not  appear  on 
the  front  page. 


5.2   Select  Data  Base 

Commands  such  as  Display  Data  automatically  refer  to  the 
current  data  base.   The  Select  Data  Base  command  allows  the  user  to 
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change  the  current  data  base.   The  first  option  which  must  be  specified 
is  whether  the  current  level  of  interest  is  to  be  the  Illinois  data  base 
or  some  county  data  base  (figure  4) .   If  the  user  is  interested  in  the 
entire  state,  the  change  is  made,  and  the  system  returns  to  the  front 
page.   Otherwise,  the  user  must  specify  which  county  is  desired  (figure 
5)  before  the  system  can  complete  the  change. 

If  the  user  sets  the  current  level  of  interest  to  be  a  county, 
the  system  will  attempt  to  make  the  local  copy  of  that  data  base  as 
complete  as  possible.   If  all  the  items  for  the  data  base  are  already 


Select  desired  data  base. 


Figure  4 
Select  Area  of  Interest  Page 
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locally  available,  no  more  action  is  taken.   However,  an  attempt  will  be 
made  to  retrieve  any  items  whicb  are  not  resident.   This  is  done  so  that 
the  user  will  get  immediate  response  on  future  requests  for  item  displays 
The  mass  retrieval  of  county  items  is  possible  because  the  system  has 
local  storage  space  for  an  entire  county  data  base  and  because  the 
county  items  are  so  small  that  the  total  delay  due  to  transmitting  the 
data  is  short. 

If  the  host  system  is  unavailable,  changing  the  current  data 
base  may  not  be  feasible.   In  particular  at  least  part  of  both  a  county 
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data  base  and  the  Illinois  data  base  must  be  in  the  terminal  before 
changing  the  current  data  base  is  a  valid  option.   So,  if  the  host  is 
not  available,  and  if  only  one  data  base  is  locally  available,  the 
Select  Data  Base  button  does  not  appear  on  the  front  page.   Even  if  a 
county  data  base  and  the  Illinois  data  base  are  locally  available,  the 
user  has  no  choice  as  to  which  county  data  base  may  be  selected.   In 
this  case,  the  page  of  buttons  of  counties  (figure  5)  is  omitted  if  the 
user  selects  a  county  data  base,  and  the  system  automatically  selects 
the  locally  stored  county  data  base. 

5.3  Display  Data 

This  command  displayed  up  to  three  data  items  in  a  choice  of 
formats.   The  first  option  which  the  user  must  specify  is  which  data 
items  are  to  be  displayed  (figure  6) .   If  two  or  three  are  chosen  then 
the  display  will  be  a  table.   If  only  one  item  is  chosen,  the  user  must 
specify  whether  it  is  to  be  displayed  as  a  table  or  bar  chart  or,  if  the 
current  level  of  interest  is  the  state,  a  shaded  map  (figure  7).   At 
this  point  the  terminal  system  will  attempt  to  retrieve  those  data  items 
which  are  not  locally  available.   As  each  retrieval  is  initiated,  an 
explanatory  message  is  printed  to  the  user.   If  some  retrievals  can  not 
be  completed,  a  list  of  unavailable  items  is  printed  to  the  user. 

If  at  least  one  of  the  requested  items  is  available,  it  is 
displayed  in  the  indicated  format.   Each  of  these  displays  has  a  Continue 
botton  in  the  lower  right  corner.   In  general,  the  system  will  not 
replace  the  display  until  the  user  touches  this  button.   (This  technique 
is  also  used  for  messages  written  to  the  user.)   If  only  one  item  is 
displayed,  a  "Redisplay"  button  appears  in  the  lower  left  corner. 
Touching  this  button  allows  the  user  to  have  the  current  data  item 
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Figure  6 
Display  Data  Page 


redisplayed  in  a  different  format  without  going  back  to  the  front  page. 
If  this  button  is  touched,  the  system  goes  immediately  to  the  format 
selection  page. 

If  the  host  system  is  unavailable,  no  item  retievals  can  be 
done  so  only  locally  resident  items  can  be  displayed.   In  this  case  the 
page  presenting  all  the  items  for  the  current  data  base  is  shortened  to 
list  only  locally  available  items.   If  it  happens  that  the  current  data 
base  has  no  locally  resident  items  when  the  host  dies,  then  the  level  of 
interest  is  automatically  switched  to  be  a  data  base  for  which  items  are 


Figure  7 
Display  Format  Page 


resident.   If  no  data  base  has  any  locally  resident  items,  then  the 
current  data  base  is  set  at  the  state  level  and  the  Display  Data  button 
does  not  appear  on  the  front  page. 

5.4  Manual  Override 

This  command  allows  the  user  to  have  more  direct  control  over 
the  actions  of  the  front-end  system  than  is  allowed  by  tbe  usual  automatic 
mode.   This  command  differs  from  the  other  major  commands  in  that  it  has 
a  manual  override  page,  similar  to  the  front  page,  which  presents  five 
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sub-commands  (figure  8).   The  system  will  stay  in  manual  override  mode, 
executing  the  indicated  subcommands,  until  the  user  specifies  a  return 

to  automatic  mode.   The  five  subcommands  are: 

1.  Directory, 

2.  Delete  Items, 

3.  Retrieve  Items, 

4.  Standard  Terminal,  and 

5.  Automatic  Mode. 
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Figure  8 
Manual  Override  Page 
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Directory.   This  produces  a  list  of  the  locally  resident  items 
for  the  current  data  base. 

Delete  Items.   This  allows  the  user  to  delete  specific  items 
from  local  memory.   It  is  useful  if  the  user  wants  to  circumvent  the 
least-recently-used  replacement  algorithm  used  by  the  memory  manager. 
If  the  host  is  down,  this  button  does  not  appear  on  the  manual  override 
page. 

Retrieve  Items.   This  allows  the  user  to  retrieve  several 
items  at  once.   The  number  of  items  is  limited  only  by  the  local  memory 
size.   This  allows  more  items  to  be  retrieved  at  once  than  by  the  Display 
Data  command.   If  the  host  is  down,  this  button  does  not  appear  on  the 
manual  override  page  since  no  retrievals  would  be  possible. 

Standard  Terminal.   This  allows  the  user  to  use  the  terminal 
as  a  standard  teletype.   In  this  mode,  the  screen  is  cl<  ; i ed ,  the  keyboard 
is  enabled,  and  anything  typed  on  the  keyboard  or  read  over  the  phone 
line  is  echoed  on  the  screen.   This  mode  is  generally  used  to  re-establish 
the  connection  to  the  host  after  it  has  been  lost.   Since  this  is  vital 
to  recovery  after  the  host  has  been  unavailable,  this  button  always 
appears  on  the  manual  override  page. 

Automatic  Mode.   This  indicates  that  the  user  wants  to  leave 
manual  override. 

Since  Standard  Terminal  mode  is  the  only  way  to  recover  from 
the  host  being  unavailable,  the  Manual  Override  Button  always  appears  on 
the  front  page. 

5.5  Halt 

This  command  causes  the  DMS  front-end  system  to  terminate.   An 
unintentional  halt  can  destroy  the  stand  alone  properties  of  the  system 
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by  discarding  everything  currently  in  the  terminal.   Thus  the  user  is 
asked  to  verify  that  the  system  should  stop  (figure  9).   If  the  Continue 
button  is  hit,  the  display  returns  to  the  front  page.   If  the  Halt 
button  is  hit,  then  the  system  cleans  up  after  itself,  prints  a  message 
to  the  user,  and  goes  away. 


Figure  9 
Halt  Verification  Page 
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6.   DETAILED  SYSTEM  DESCRIPTION 

The  description  of  the  front-end  system  is  divided  into  six 
areas: 

1.  the  software  written  to  run  on  the  host  system, 

2.  the  terminal  operating  system, 

3.  front-end  system  support  software, 

4.  front-end  data  structures, 

5.  front-end  memory  manager,  and 

6.  front-end  user  interface  software. 
Detailed  discussions  of  these  areas  follow. 

6.1  Host  Support  Software 

One  special  purpose  routine  was  written  to  run  on  the  Multics 
host  system.   This  routine,  which  interfaced  to  the  Janus  system,  prepares 
data  items  for  transmission  by  attaching  leading  and  trailing  information. 
The  data  elements  are  ordinarily  transmitted  from  the  host  as  the  character 
representation  of  the  numbers.   The  interfacing  routine  prepends  to  this 
list  a  synchronizing  header  sequence  and  the  number  of  values  to  be 
transmitted.   The  trailer  consists  of  a  synchronizing  sequence  used  to 
detect  error  conditions  in  transmission.   For  ease  of  interfacing  between 
Multics  and  the  PDP-11,  all  item  values  were  transmitted  as  the  ASCII 
representation  of  the  number,  and  transformed  into  the  PDP-11 's  internal 
format  by  software  in  the  terminal. 

6.2  Operating  System 

A  small  multi-processing  operating  system  was  written  for  the 
terminal.   The  facilities  in  this  system  which  are  of  specific  concern 


23 

to  the  DMS  front-end  are  the  I/O  system  and  screen  panel  accessing 
facilities.   These  two  types  of  routines  are  further  explained  below. 

I/O  system.   In  this  subsystem,  a  device  must  be  owned  before 
it  can  be  accessed.   At  most  one  process  at  a  time  can  own  each  device. 
Accordingly  the  operating  system  supplies  the  subroutines  open  and  close 
to  allow  a  process  to  request  and  relinquish  ownership  of  a  device. 
Once  a  device  is  owned,  it  can  be  read  from  and  written  to  by  the  read 
and  write  subroutines. 

Panel  accessing.   Several  routines  provide  facilities  for 
writing  to  the  screen.   One  of  these  is  screen_clear  which  erases  the 
entire  screen.   Two  more  routines  allow  strings  of  text  to  be  written. 
set_cursor  determines  where  the  printing  will  start  (i.e.,  positions  the 
cursor) .   printf  allows  formatted  printing  of  one  constant  string  with 
an  arbitrary  number  of  parameters. 

These  routines  are  documented  more  fully  in  Appendix  C. 

6.3   Front-End  Support  Software 

This  classification  includes  routines  which  are  very  low  level 
so  far  as  the  actual  DMS  front-end  is  concerned,  but  which  are  too 
specific  to  be  considered  operating  system  functions.   Four  of  these  are 
described  below. 

clr  line.   This  routine  blanks  out  a  specified  number  of 
character  lines  on  the  screen.   It  starts  at  a  specified  line  and  then 
positions  the  cursor  at  the  left  edge  of  the  topmost  cleared  line. 

terminal.   This  procedure  causes  the  terminal  to  simulate  a 
normal  teletype.   It  takes  input  from  the  keyboard  and  the  phone  line. 
All  input  is  printed  on  the  screen,  and  input  from  the  keyboard  is 
written  to  the  phone  line.   Input  is  buffered  before  it  is  printed  so 
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that  characters  from  the  phone  line  and  from  the  keyboard  are  not  inter- 
spersed on  the  same  line.   This  routine  is  used  by  the  front-end  to 
allow  the  user  to  log  in  to  the  remote  host. 

get  janus  values  and  pr  help.   These  two  routines  retrieve 
information  from  the  host  into  the  terminal.   get  janus  values  is  used 
to  retrieve  a  data  item.   To  do  this,  get_Janus__values  formulates  and 
transmits  a  command  line  to  the  host  which  will  cause  the  host  system  to 
send  back  the  desired  item.   The  incoming  information  is  checked  to  make 
sure  that  the  leader  and  trailer  sequences  are  proper,  and  that  the 
correct  number  of  elements  are  received.   If  the  item  is  in  proper  form, 
the  element  values  are  converted  into  internal  format  and  stored  in  the 
specified  memory  location.   A  returned  status  word  indicates  the  success 
or  type  of  failure  of  the  attempted  retrieval. 

pr_help  displays  a  page  of  explanatory  text  on  the  screen. 
This  text  is  retrieved  by  formulating  and  shipping  over  the  phone  line  a 
command  which  will  cause  the  proper  explanatory  paragraph  to  be  shipped 
back.   The  resulting  input  from  the  phone  line  is  treated  as  being  the 
help  text.   The  header  sequence  is  stripped  off,  and  everything  up  to 
the  trailer  field  is  printed  on  the  screen. 

These  routines  are  documented  more  fully  in  Appendix  C. 

6.4  Front-End  Data  Structures 

In  order  to  simplify  the  front-end  software  both  conceptually 
and  in  terms  of  the  amount  of  code  required,  two  common  constructs  were 
represented  by  the  structures  item_tag  and  level_variables .   The  exact 
definition  of  these  structures  is  included  in  Appendix  B. 

item  tags.   As  was  mentioned  in  Chapter  5,  many  options  cease 
to  be  valid  if  the  host  is  unavailable.   In  order  that  the  corresponding 
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buttons  will  not  be  displayed  in  this  case,  each  potential  button  has  an 
item  tag  associated  with  it.   This  structure  has  two  parts:  a  label  and 
an  availability  flag.   The  label  field  contains  the  name  of  the  option 
or  the  label  for  button  to  be  displayed.   The  availability  part  is  a 
flag  which  is  true  if  the  option  is  valid  when  the  host  is  unavailable 
and  false  otherwise.   This  structure  is  widely  used  in  the  front-end 
software. 

level  variables.   One  of  the  design  goals  of  the  front-end 
system  is  the  ability  to  keep  portions  of  two  different  data  bases  in 
local  memory  simultaneously.   Although  these  two  data  bases  are  similar 
in  structure,  they  differ  in  details  such  as  item  names,  number  of 
items,  size  of  local  memory,  etc.   In  order  to  keep  such  details  readily 
available,  a  level__variables  structure  is  associated  with  both  the  state 
and  county  data  base.   The  information  kept  in  these  structures  is 
detailed  in  Appendix  B.   In  general  this  structure  includes  all  information 
which  depends  on  the  type  of  data  base. 

6.5  Memory  Manager 

The  memory  management  routines  have  the  responsibility  of 
maintaining  the  local  memory  cache  in  an  as  up-to-date  state  as  possible. 
This  includes  retrieving  data  items  from  the  host  and  determining  which 
locally  resident  items  are  to  be  overwritten,  as  necessary.   The  description 
of  the  memory  manager  includes  an  explanation  of  the  memory  organization 
and  a  discussion  of  four  procedures: 

1.  lru, 

2.  retr_item, 

3.  retr_many_item,  and 

4.  fetch  county. 


26 


Memory  organization.   The  local  memory  is  divided  into  two 
sections,  one  for  each  type  of  data  base.   Each  local  data  memory  is 
divided  into  slots  the  size  of  one  item.   Every  slot  has  an  associated 
time-stamp  which  indicates  the  last  time  that  slot  was  referenced. 
These  time-stamps  are  used  to  determine  which  item  to  replace  as  new 
items  are  retrieved.   The  availability  flags  for  the  items  in  each  data 
base  indicate  not  only  whether  or  not  the  item  is  currently  resident  in 
the  terminal  but  also  which  memory  slot  the  item  occupies.   Figure  10 
diagrams  part  of  the  local  memory  in  a  typical  state.   The  diagram  shows 
the  memory  containing  three  items.   Item  "%  Pop  change"  is  not  locally 
resident,  as  indicated  by  an  availability  flag  of  0. 

lru.   This  is  the  placement  routine  for  the  memory  manager. 
It  implements  a  least-recently-used  algorithm  to  determine  which  memory 
slot  is  available  for  use  by  a  new  data  item. 
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Memory  Organization 
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retr  item.   This  low  level  routine  retrieves  a  data  item  from 
the  host.   It  uses  lru  to  find  an  available  memory  slot  and  get_janus_values 
to  actually  fetch  the  item.   retr_item  contains  checks  to  assure  that 
the  item  retrieved  by  get_janus_values  was  retrieved  correctly.   The 
retrieval  is  complete  either  when  the  item  has  been  fetched  correctly  or 
when  the  host  becomes  unavailable.   When  the  retrieval  is  completed 
retr_item  updates  the  availability  flag  of  each  item  to  indicate  the  new 
state.   This  includes  marking  the  item  which  previously  occupied  the 
pre-empted  memory  slot  as  being  gone,  as  well  as  updating  the  flag  of 
the  new  data  item. 

retr  many  items.   When  a  user  requests  several  data  items, 
additional  checks  are  performed  by  retr__many_i terns  to  assure  that  resident 
requested  items  are  not  over-written  as  other  items  are  retrieved. 
retr_many_i terns  makes  a  first  pass  through  the  list  of  requested  items 
checking  the  availability  flag  of  each  item.   If  the  flag  is  non-zero, 
then  the  item  is  locally  resident.   If  the  item  was  deleted  from  manual 
override  node,  it  is  undeleted.   The  time-stamp  of  the  slot  occupied  by 
the  item  is  updated.   If  some  of  the  requested  items  are  not  locally 
available,  retr_many_i terns  makes  a  second  pass  through  the  list.   On 
this  pass,  retr_items  is  used  to  retrieve  the  unavailable  items.   If  one 
or  more  items  are  not  available  and  cannot  be  retrieved  because  of  host 
failure,  an  explanatory  message  listing  the  unavailable  items  is  displayed 
to  the  user. 

fetch  county.   When  an  individual  data  item  is  referenced,  the 
presence  of  the  item  is  determined  by  its  availability  flag.   Since  the 
same  list  of  items  is  used  for  all  the  county  data  bases,  this  check  is 
not  sufficient  when  an  entire  county  is  to  be  retrieved.   In  this  case, 
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the  check  must  be  for  the  availability  of  each  item  for  the  desired 
county  data  base.   This  requires  the  checking  of  two  availability  flags: 
for  the  item  and  one  for  the  county.   Since  the  list  of  counties  is 
actually  a  list  of  item_tag  structures,  the  availability  flags  are  used 
to  indicate  which  county  data  base  is  currently  resident  in  the  terminal. 
a   a  county  data  base  is  requested,  fetch  county  will  retrieve  an  item 
Li  the  availability  for  either  the  item  or  the  county  is  false.   After 
all  necessary  retrievals  have  been  done,  or  after  the  host  becomes 
unavailable,  the  flags  for  the  counties  and  the  data  items  are  updated 
by  f etch_county .   This  includes  resetting  the  availability  flag  for  the 
old  county  and  setting  the  flag  for  the  new  county,  if  any  new  items 
were  retrieved.   Also,  if  the  host  went  down  after  some  items  were 
retrieved,  the  flags  for  any  items  remaining  from  the  old  county  must  be 
reset.   If  the  host  goes  down  before  any  items  for  the  new  county  can  be 
retrieved,  the  memory  and  availability  flags  are  left  as  they  were  upon 
entrance  to  f etch_county .   After  the  memory  has  been  updated  as  much  as 
possible,  fetch_county  returns  to  the  calling  procedure  the  index  of  the 
county  which  actually  has  data. 

The  memory  management  routines  are  presented  in  more  detail  in 
Appendix  A. 

6.6  User  Interface 

This  portion  of  the  system  includes  facilities  for  coordinating 
the  various  interactions  between  the  user  and  the  terminal  system.   This 
includes  displaying  and  interpreting  pages  of  buttons,  displaying  data 
items  in  the  proper  format,  and  controlling  the  flow  of  the  menu  of 
options  presented  to  the  user.   Each  of  these  sections  is  discussed 
further  below. 
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Button  routines.   To  facilitate  the  utilization  of  the  touch 
panel,  the  terminal  system  uses  the  internal  concept  of  a  button  as  a 
structure.   Nine  routines  which  provide  the  button  facilities  are  broken 
into  three  categories: 

1.  Six  routines  which  deal  directly  with  creating,  using  and 
deleting  individual  buttons. 

2.  get_touch,  a  general-purpose  button  handling  procedure. 

3.  get_command  and  user_command,  button  facilities  which  work 
specifically  with  the  front-end  system. 

Explanations  of  these  routines  follow. 

When  created,  a  button  has  specific  dimensions,  position  on 
the  screen,  and  label.   The  creation  process  consists  of  entering  the 
button  definition  into  the  internal  button  table.   This  is  done  by  the 
procedure  add_command.   The  button  is  not  actually  displayed  until  it  is 
activated  by  a  call  to  the  activate  procedure.   After  a  screen  has  one 
or  more  active  buttons  displayed  the  program  can  read  the  user's  touch 
input  by  means  of  get_command.   This  procedure  reads  the  coordinates  of 
a  screen  touch,  and  compares  those  coordinates  with  the  areas  inside  all 
active  buttons.   If  the  touch  is  determined  to  be  inside  a  button,  then 
the  button  on  the  screen  is  flashed  and  a  special  internal  tag,  which  is 
associated  with  the  touched  button,  is  returned  to  the  calling  procedure. 
Flashing  a  button  consists  of  lighting  all  the  dots  inside  the  button, 
then  turning  them  off  and  re-displaying  the  button  as  before.   This 
feedback  indicates  to  the  user  that  a  touch  was  recognized  by  the  system. 
If  the  touch  is  not  inside  any  button,  it  is  ignored. 

After  a  button  has  been  used,  one  of  two  things  is  done  to  it. 
Either  it  is  deactivated  by  the  deactivate  procedure  or  it  is  deleted  by 
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the  del_conunand  procedure.   Deactivating  is  the  opposite  of  activating 
in  that  the  button  is  marked  as  inactive  but  the  button  definition  is 
not  removed  from  the  internal  button  table.   When  a  button  is  deleted, 
its  definition  is  removed  from  the  table.   In  either  case  the  button  is 
left  displayed  on  the  screen  and  must  be  explicitly  erased.   This  is 
usually  done  by  erasing  the  entire  screen  of  buttons  via  screen_clear. 
A  button  may  be  individually  erased  by  the  lite_box  procedure. 

The  procedure  get_touch  uses  the  above  button  handling  routines 
to  display  a  page  full  of  buttons  and  to  allow  the  user  to  pick  up  to  a 
maximum  number  of  them.   This  routine  takes  as  input  a  list  of  button 
labels,  a  list  of  internal  tags  to  be  associated  with  the  buttons,  and 
the  maximum  number  of  buttons  to  be  picked.   It  then  creates  and  displays 
buttons  of  a  standard  size,  centered  as  a  group  on  the  screen.   Additionally, 
Proceed  and  Cancel  buttons  are  created  in  the  lower  corners.   Finally  an 
explanatory  message,  also  input  to  the  procedure,  is  displayed  on  the 
screen. 

As  the  user  touches  the  buttons,  two  actions  are  taken.   First 
the  selected  button  is  marked  as  having  been  touched  by  placing  a  small 
box  in  the  lower  right  corner  of  the  button.   Second,  the  message  to  the 
user  is  updated  to  reflect  the  number  choices  still  available.   After 
the  user  has  chosen  the  maximum  allowable  number  of  buttons,  the  message 
is  changed  to  read  "Hit  Proceed  to  continue."   If  the  user  makes  more 
selections  after  this  point,  the  new  buttons  are  recognized  as  being 
touched,  but  buttons  chosen  initially  are  deleted  from  the  list  of 
choices.   This  keeps  the  number  of  choices  from  exceeding  the  allowed 
limit. 
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If  the  user  wishes  to  delete  a  selection,  a  button  can  be 
unselected  by  touching  it  again.   When  this  occurs,  the  marking  box  is  erased 
and  the  message  is  again  updated.   After  the  user  is  satisfied  that  the 
appropriate  options  have  been  specified,  the  Proceed  button  must  be 
touched.   Forcing  the  user  to  always  explicitly  indicate  that  all  decisions 
have  been  made  allows  the  user  to  change  a  bad  selection  or  correct  an 
extraneous  touch.   At  any  time  before  the  Proceed  button  is  hit  the  user 
may  abort  a  command  by  touching  the  Cancel  button.   If  this  is  done,  the 
current  page  of  buttons  is  erased,  get_touch  returns  a  special  code  to 
the  calling  procedure,  and  the  terminal  system  returns  to  the  front  page 
display. 

After  the  desired  buttons  have  been  chosen,  and  the  Proceed 
button  touched,  get_touch  cleans  up  after  itself  and  returns  to  the 
calling  procedure.   The  cleaning  up  includes  erasing  the  screen  and 
deleting  all  the  buttons  it  created.   The  returned  information  includes 
the  number  of  buttons  chosen  and  a  list  of  the  internal  tags  of  the 
chosen  buttons. 

The  details  of  the  seven  general  button  handling  routines 
discussed  so  far  are  included  in  Appendix  C. 

The  procedure  get_choice  was  built  to  specifically  interface 
between  the  front-end  system  and  get_touch.   get_choice  is  used  to  build 
a  list  of  valid  options  and  pass  this  list  to  get_touch  along  with  the 
other  necessary  information.   An  option  is  valid  if  either  the  availability 
flag  of  the  button  is  true  or  a  master  flag,  also  input  to  get_choice, 
is  true.   The  master  is  usually  a  flag  which  is  true  if  the  host  is 
available,  and  false  otherwise.   The  tags  to  be  associated  with  the 
buttons  are  generated  by  get_choice  to  be  the  index  of  the  buttons  in 
the  list  input  to  get_choice.   This  procedure  allows  the  main  coordinating 
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procedure  of  the  front-end  to  ignore  the  state  of  the  backup  host  so  far 
as  determining  valid  options  is  concerned.   This  helps  simplify  the  main 
routine. 

The  last  major  button  handling  routine  is  user_command .   This 
procedure  is  used  to  display  buttons  in  the  format  of  the  front  and 
manual  override  pages.   The  buttons  on  these  pages  are  different  from 
the  other  buttons  used  by  the  front-end  system.   They  are  created  as  the 
main  or  manual  override  loop  is  entered  and  then  merely  activated  and 
deactivated  until  the  loop  is  exited.   This  saves  the  overhead  of  creating 
these  few  buttons  every  time  they  are  used.   The  procedure  user  command 
takes  a  list  of  pointers  into  the  button  table  and  the  availability 
flags  for  the  commands.   Using  the  same  approach  as  get_command  to 
determine  validity,  the  valid  commands  are  activated.   The  user  is 
allowed  to  select  one  command,  with  no  provision  for  changing  a  touch. 
(This  is  not  significant  since  every  command  generates  a  follow  up  page 
which  has  a  Cancel  button.)   After  the  command  is  chosen,  the  buttons 
are  deactivated  and  the  screen  is  cleared.   The  internal  tag  of  the 
chosen  command  is  returned  to  the  calling  procedure. 

The  code  and  more  detailed  explanations  of  the  procedures 
get_command  and  user_command  are  included  in  Appendix  A. 

Data  item  displays.   The  user  interface  also  includes  facilities 
for  displaying  data  items  in  three  different  formats:   table,  bar  chart, 
and  shaded  map. 

The  table  is  the  simplest  of  the  formats.   This  routine  will 
take  up  to  three  data  items  and  display  them  as  columns  of  numbers 
centered  as  a  group  on  the  screen.   The  columns  are  labeled  by  the  item 
names  and  separated  by  vertical  lines.   The  rows  are  labeled  by  the 
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county  or  town  names  and  every  third  row  is  marked  by  a  dotted  line. 
This  is  a  very  standard  format.   Missing  data  values  are  displayed  as  an 
asterisk  (*) . 

The  second  type  of  display  presents  one  item  as  a  standard  bar 
chart  centered  on  the  screen.   The  element  values  are  represented  as 
horizontal  bars,  labeled  on  the  right  with  the  numeric  value  of  the 
element  and  on  the  left  by  the  element  name.   The  entire  display  is 
labeled  at  the  bottom  with  the  item  name.   The  bars  are  scaled  so  that 
the  smallest  values  becomes  relative  zero  and  the  bar  for  the  largest 
value  fills  the  maximum  allowable  area.   All  other  values  are  scaled 
linearly  between  the  maximum  and  minimum.   Again  missing  data  values  are 
represented  by  an  asterisk. 

The  third  type  of  display,  a  shaded  map,  is  only  available  for 
items  in  the  Illinois  data  base.   This  routine  draws  an  outline  map  of 
the  twenty-nine  northern  counties  of  Illinois.   The  element  values  of 
the  items  are  divided  into  five  ranges.   Each  county  is  filled  in  with 
one  of  five  shades  depending  on  which  range  includes  the  value  for  that 
county.   Counties  with  missing  data  values  are  left  blank. 

The  three  display  routines  are  outlined  in  Appendix  C. 

Flow  control.   The  main  driver  coordinates  the  above  procedures 
to  make  the  terminal  perform  as  discribed  in  Chapter  5.   When  the  terminal 
system  first  comes  up,  the  driver  initializes  all  the  level  structures, 
item  names,  element  names,  button  labels,  availability  flags,  and  textual 
constants  which  are  needed.   For  the  most  part,  once  these  values  are 
initialized,  they  are  never  changed.   Working  pointers  are  switched  to 
reference  whatever  values  are  currently  in  use.   After  this  initialization 
is  done,  the  driver  opens  the  touch  panel  and  the  phone  line,  and  allows 
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the  user  to  log  into  the  remote  host.   When  this  is  done,  the  terminal 

system  goes  to  the  front  page  display.   From  this  point  on,  the  driver 
simply  loops  through  successive  commands  until  the  user  indicates  that 
the  front-end  system  should  halt.   At  that  point,  after  receiving  verifica- 
tion, the  driver  closes  the  devices  it  opened,  prints  a  final  message, 
and  returns  to  the  operating  system  supervisor. 

The  main  work  of  the  driver  is  done  in  the  loop  which  executes 
user  commands.   For  the  most  part,  this  entails  coordinating  other 
procedures  in  a  straight-forward  manner  under  the  guidelines  of  Chapter 
5.   However,  two  functions  of  the  driver  are  not  completely  obvious  to 
the  user.   First  the  driver  must  ensure  that  the  system  housekeeping  is 
done  at  the  beginning  of  every  pass.   Second,  care  is  taken  so  that  a 
county  data  base  is  not  overwritten  unnecessarily. 

The  system  housekeeping  includes  updating  availability  flags 
for  commands  such  as  Display  Data  or  Select  Data  Base  if  these  commands 
became  valid  as  the  result  of  actions  of  the  previous  command.   Also, 
the  driver  must  ensure  that  the  terminal  system  is,  if  at  all  possible, 
using  a  data  base  which  has  resident  data  if  the  host  is  down. 

If  the  driver  always  retrieved  a  county  data  base  when  a  user 
switched  the  level  of  interest  to  it,  then  some  counties  for  which  all 
the  items  had  zero  elements  would  be  retrieved.   (A  county  data  base 
will  have  zero-length  items  if  that  county  has  no  towns  with  populations 
greater  than  2500.)   In  this  case,  the  fact  that  the  county  has  no  large 
towns  is  noted,  and  the  old  county  data  base  is  left  intact  in  the 
terminal.   This  approach  prevents  unnecessary  loss  of  data,  allows  the 
user  to  go  back  to  the  old  county  of  interest  without  retrieving  the 
data  items  again,  and  keeps  more  interesting  data  available  if  the  host 
should  become  unavailable. 
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With  these  two  exceptions,  the  actions  of  the  front-end  driver 
closely  follow  the  system  description.   A  more  detailed  description  of 
the  dms_front_end  procedure  is  included  in  Appendix  A. 
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7.   CONCLUSIONS 

After  the  terminal  front-end  system  was  built,  it  was  demonstrated 
for  two  groups  of  people.   During  the  first  set  of  demonstrations  approxi- 
mately thirty  people  from  the  Joint  Technical  Support  Activity  (the 
project  funding  agency)  saw  the  terminal.   The  second  set  of  demonstrations 
reached  approximately  one  hundred  civilian  and  militar y   personnel,  from 
the  Pacific  Command.   These  people  ranged  from  system  programmers  to  DMS 
users  to  senior  administrative  personnel.   As  a  result  of  these  demonstra- 
tions and  our  own  observations,  several  good  and  bad  points  of  the 
front-end  system  were  recognized.   These  results  and  possible  future 
research  is  discussed  below. 

Demonstration  results.   The  terminal  system  has  several  short- 
comings.  Some  of  these  were  the  result  of  restrictions  designed  to  keep 
the  demonstration  system  simple  and  were  not  felt  to  be  significant 
conceptual  restrictions.   Others  were  more  basic  shortcomings. 

The  restrictions  implemented  for  the  sake  of  simplicity  include: 

1.  limiting  the  size  of  the  data  base  so  that  all  displays  will 
fit  on  one  page, 

2.  assuming  that  data  items  are  not  being  updated  at  the  host 
system,  and 

3.  not  making  more  displays  touchable. 

The  assumption  that  data  items  are  static  was  valid  in  the  case  of  the 
data  base  used  in  this  demonstration.   However  the  system  could  be 
easily  changed  to  check  for  updates  if  this  was  necessary.   The  tou.i: 
facility  could  have  been  utilized  for  more  displays.   For  example,  the 
shaded  map  could  have  been  made  touchable  so  that  touching  a  particular 
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county  would  cause  the  information  for  that  county  to  be  displayed. 
These  extensions  of  the  demonstration  system  might  be  worthwhile  in  an 
actual  system,  but  were  felt  to  be  unnecessary  in  this  original  version. 

A  more  basic  shortcoming  of  the  demonstration  system  is  the 
fact  that  data  items  can  only  be  retrieved,  not  updated  or  created. 
Probably  the  single  most  frequently  asked  question  from  people  who 
viewed  the  terminal  concerned  how  data  might  be  input  through  this  type 
of  system.   This  seems  to  indicate  that  data  input  is  a  significant 
concern  for  users,  and  that  they  want  a  better  way  of  inputting  information. 
Data  input  capabilities  were  not  implemented  in  the  demonstration  system 
primarily  because  of  time  constraints.   However,  any  such  system  which 
is  designed  for  actual  rather  than  demonstration  use  should  consider  the 
problem  of  data  input  and  updating. 

In  spite  of  these  shortcomings,  the  demonstration  system  was 
very  favorably  received.   The  demonstrations  were  introduced  by  approxi- 
mately fifteen  minutes  of  lecture  covering  the  concepts  to  be  demonstrated. 
This  was  followed  by  a  demonstration  performed  by  a  member  from  the 
audience.   After  the  short  introductory  lecture,  the  audience  members 
were  able  to  successfully  get  displays  of  data,  change  default  data 
bases,  etc.,  using  only  the  instructions  included  in  the  front-end 
system  itself. 

Overall,  the  demonstration  system  was  successful  in  improving 
the  human  interface  in  the  areas  addressed.   The  combination  of  the 
touch  input  mechanism  and  the  menu  selection  in  the  user's  jargon,  made 
the  system  easy  to  use.   This  was  demonstrated  by  the  people  who  saw  the 
system.   The  combined  front-end  and  host  system  was  more  reliable  than 
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the  host  by  itself.   Several  times  during  the  demonstrations  the  terminal 
masked  the  failure  of  the  host  or  communication  facility. 

Future  research.   Many  areas  of  the  philosophy  implemented  in 
the  demonstration  terminal  system  lead  to  further  research.   Some  possible 
extensions  are  discussed  below. 

1.  The  local  data  manipulating  capabilities  might  be  expanded. 
Methods  of  updating  data  values  via  touch  input  might  be 
studied.   Also,  the  possibility  of  using  the  local  processing 
power  to  perform  calculations,  such  as  correlations  between 
times,  on  the  local  data  might  be  explored. 

2.  The  menu  selection  approach  should  be  studied.   This  approach 
can  be  very  limiting.   Further  study  might  include  the  problem 
of  how  the  system  can  be  made  more  flexible  for  the  experienced 
user  and  still  be  easy  for  the  novice  to  use.   Further,  the 
possibility  of  allowing  the  user  to  create  abbreviations  for  a 
sequence  of  commands  might  be  of  interest  as  the  system  grows 
more  complex. 

3.  As  the  system  grows  in  capabilities,  the  structure  of  the 
system  will  have  to  be  carefully  considered.   The  demonstration 
system  presented  basically  a  tree  of  commands.   That  tree  had 
only  three  levels  and  every  node  had  only  a  few  (two  to  thirty) 
possible  sub-branches.   Other  systems  may  not  easily  fit  into 
such  a  conceptually  simple  hierarchy.   Structuring  a  system 
with  many  possible  functions  on  a  complex  set  of  data  so  that 

a  user  can  grasp  that  structure  may  be  a  significant  problem. 

4.  Even  more  user  feedback  and  hand-holding  can  be  built  into  the 
terminal.   Possibly  the  terminal  could  be  expanded  to  utilize 
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two  or  more  screens.   One  screen  could  perform  the  same  types 
of  functions  as  the  current  terminal.   The  other  might  serve 
one  of  several  functions.   It  might  be  a  user  manual,  constantly 
displaying  the  help  text  for  the  current  command  options.   It 
might  allow  the  user  to  carry  on  a  conversation  with  another 
user  about  the  information  being  displayed.   It  might  be  a 
scratch  pad  for  the  user's  personal  use.   The  possibility  of 
using  extra  screens  to  perform  one  or  more  of  these  functions 
poses  interesting  problems. 

These  are  some  areas  of  possible  further  work  which  have  grown 
out  of  the  current  project.   Each  of  these  areas  holds  promise  for 
Improving  the  human  interface  to  data  management  systems.   Further,  this 
development  should  not  be  prohibitively  difficult.   The  demonstration 
system,  which  made  a  first  pass  at  improving  the  user  interface,  took 
only  nine  programmer-months  to  design  and  build.   Further  improvements 
should  be  possible  without  excessive  programmer  efforts.   Considering 
the  costs  and  potential  benefits,  further  study  of  intelligent  terminals 
as  interfaces  to  existing  systems  seems  worthwhile. 
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APPENDIX  A 
Front-End  System  Code 
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APPENDIX  B 
Front-End  Data  Structures 
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struct  item  tag  { 

char  *name 

int  avail 

} 


1.  name        Pointer  to  a  character  string  which  is  the  name  ot 

this  item/button.   This  string  is  used  for  labeling 
various  displays  and  buttons  presented  to  the  user. 

2.  avail       Integer  flag  indicating  whether  this  is  a  valid 

button  it  the  host  is  unavailable.   A  value  of  0 
means  that  this  button  is  only  valid  if  the  backup 
host  is  available;  non-zero  indicates  validity  even 
if  the  host  is  not  available.   Generally,  this  flaq 
is  a  simple  1  or  0.   For  data  items,  extra 
information  is  stored  in  this  flag.   (See  discussion 
of  the   items'  component  of  the  level  variables 
structure . ) 
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struct  level  variables  { 


int 

struct 

char 

int 

char 

int 

int 

int 

char 

int 

int 


item  tag 


num  items 
*items  ; 
**item  j  n 
num  elemen 
**elt  name 
num  arrays 
*mem  array 
*time  stam 
*dsn  ; 
num  displa 
item  resid 


ame 
ts 


ys 
ent 


num  items 
items 


The  number  of  items  in  this  data  base 


( Integer ) 


Pointer  to  an  array  of  item  tag  structures  for  the 
items.   Each  item  in  the  data  base  has  an  item  tan 
structure  associated  with  it.   This  structure 
contains  the  name  of  the  item  and  its  availability 
flag.   The  the  avail  flag  is  0  if  the  item  is  not 
locally  resident,  negative  if  it  is  resident  but 
marked  as  deleted,  and  positive  if  it  is  resident 
and  not  deleted.   If  the  avail  flag  is  non-zero,  the 
value  of  the  flag  indicates  which  memory  slot 
contains  the  item's  value. 


item  j  name 


num  elements 


Pointer  to  the  list  of  character  strings  which  are 
the  item  names  as  used  in  the  Janus  system.   This  is 
used  in  formulating  the  recruest  for  data  transmition 
from  the  host  system. 

The  number  of  data  elements  in  each  item  in 


elt  name 


num  arrays 


mem  array 


time  stamp 


this  data  base.   (Integer) 

Pointer  to  the  list  of  character  strings  which  are 
the  element  names  for  this  data  base.   This  list  is 
used  for  labeling  the  element  values  in  table  and 
bar  graph  displays. 

Number  of  slots  in  the  local  memory  for  this  data 
base.   Used  in  keeping  track  of  the  amount  of  local 
storage  available.   (Integer) 

Pointer  to  a  list  of  integers  which  are  the  starting 
addresses  of  local  memory  slots.   Used  when 
referencing  or  retrieving  the  values  of  a  data  item. 

Pointer  to  a  list  of  time  stamps  (integers) 
associated  with  the  local  memory  slots.   The  time 
stamp  associated  with  a  slot  indicates  the  last  time 
the  contents  of  that  slot  were  referenced.   These 
times  are  used  to  determine  which  item  is  replaced 
when  a  new  item  is  retrieved  from  the  remote  host. 
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dsn 


Pointer  to  a  character  string  which  is  the  name  of 
the  current  data  base.   Used  in  formulating  the 
request  for  data  from  the  remote  host  and  for 
messages  to  the  user.   For  the  Illinois  data  base, 
this  is  the  word   Illinois";  for  a  county  data  base 
it  is  the  name  of  the  county  (e.g.,  "Cook"). 


10.  num  displays 


The  number  of  types  of  data  displays 
available  for  items  in  this  data  base.   For  the 
Illinois  data  base  it  is  three  (table,  bar  chart, 
and  shaded  map);  for  the  county  data  bases  it  is  two 
(table  and  bar  chart).   (Integer) 


11.  item  resident       Integer  boolean  flag  indicating  if  any  data 

for  this  data  base  is  resident  in  the  terminal. 
Used  for  determining  when  certain  buttons  represent 
valid  commands  even  if  the  host  is  unavailable. 
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/*   This    is    the    include    file   /mnt/deb/thesi s/demo    text.incl    */ 

/*    the    list    of   county   names    */ 

char  *county    names    [num    counties] 

{Boone",    :Bureau" ,      Carroll",    "Cook'  ,    "DeKalb", 
"DuPage"  ,    'Grundy,    "Henderson'  ,      Henry', 
JoDaviess",    "Kane",    "Kankakee",    "Kendall",    "Knox', 
"LaSalle",    "Lake",    "Lee",    "Marshall1-,    "McHenry", 
"Mercer",    "Ogle",     "Putnam",    "Pock    Island",    "Stark", 
"Stephenson",    "barren",    "Whiteside",     "Will', 
"Winnebago" }    ; 

/*    list    of    town   names   Dy   county    */ 

char  *town    names    [num_counties]     [max    num    towns] 

{ "  Bel  v  id  ere"  ,  '",  "",  " ,T ,  ■•", 

"Spring  Valley",   Princeton",  "",  "",  "", 

" Savanna" ,  " " ,  " " ,  " " ,  " " , 

"Barrington  His",   Arlington  Hts"  .   Hanover  Park", 
"Niles",  "Winnetka ' , 

"Genoa",  "De  Kalb" ,  "Sandwich",  "Sycamore",  ' " , 

"Villa    Park",    "Hinsdale',    "Glen    Ellyn"  ..    "Lombard", 
" Bloomingdale" , 

"Coal    City",    "Morris",    "',    '",    " " , 

till! 

"Geneseo" ,    "Green    Rock",    "Galva" ,    "Kewanee" ,    "", 
"Galena" ,    '  " ,    " " ,    u " ,    " "  , 
S   Elgin",    "N  Aurora1'.    "Elgin",    "St    Charles", 

"Carpenter sville" , 
"Bradley",  "Borubonnais" ,  "Momence" ,  "Manteno", 

"Kankakee" , 
"Piano",  "",  "",  "■',  " ", 

"Abingdon",  "Knoxville"  ,  "Galesburg" ,   ",  "", 
"Peru",  "Ottawa",  "Mendota" ,  "La  Salle",  "Oglesby" , 
"Round  Lk  Bch"  ,  "Park  City  ,  "Round  Lk  Pk" , 

"N  Chicago" ,  "Mundelein" , 
"Dixon" ,  " ' ,  " " ,  " " ,  " " . 
"Henry",  "Toluca" ,  "",  "",  "", 
"Woodstock",  "Crystal  Lake",  "Harvard",  "Algonauin" , 

"Lake  in  the  His" , 
"Aledo" ,  " " ,  " " ,  " '  ■  ,  "" , 
"Mt  Morris",  "Polo",  "Rochelle",  "Oregon",  "" , 

r  r  i  i  t 

"Rock  Island",  "Coal  Valey" ,  "Silvis",  "Moline", 

"East  Moline" , 
,    t         '         t         t 
"Freeport" ,  " " ,  "" ,  "" ,  " " , 
"Monmouth" ,  "" ,  " " ,  "" , 

"Morrison",  "Rock  Falls",  "Fulton",  "Sterling",  "", 
"Romeoville" ,  "Steger",  "Crest  Hill",  " Bol ingbrook" , 

"Plainf ield" , 
"S  Beloit",  "Rockford'  ,  "Loves  Park",  "",  ""}  ; 
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/*  list 
char 


of  state  item 
*st  itm  names 


names  for  the  user  */ 
[num  state  items] 
{"Population",  "Pop/Sci  Mile",   %  Pop  Chanqe" , 
"  %  Female",  "%  Urban".  "%  Chng  Negro",  '•%  Poo 

%  Pop  >  18",  "%  Pop  >  65",  "Negro  Pop",  " 
"Birth  Rate",  "Death  Rate",  "Pres  Votes", 
'Land  Area",  "Families",  "%  Low  Income",  " 
"Syphilis",  "Gonorrhea",  ''Bank  Deps" , 
"M.  H.  Admiss" ,  "M.  H.  Pop",  "Gas  Stations 
"Suicide  Rate",  "Nat  Gas  Prod',  '#  Streams 
"Miles  Stream',  "Acres  Stream'}  ; 


<  5"  , 
%  Span  ish" , 

Med  Fam  Inc" 


/*  list 
char 


of  state  item  names  for  janus  */ 
*st  j  itm  names  [num  state  items] 


{ "cc72002 
"  cc 7 2  00  7 " 
cc72013" 
"CC72  019" 
•cc72071" 
"CC72041" 
"vs70027" 
"cons72  011 


,  "cc72003 
"cc72010" 
"cc72009" 
"CC720B5" 
"CC72075" 
"mh72002" 
"mn72001" 

"}  ; 


"cc72004 
"CC72011 " 
"CC72017 ' 
' CC72069' 
"VS72001" 
"mh72010" 
"cons72001 


"  cc7 
cc72 
cc72 
cc72 
vs72 
bu67 

CO 


2006 
012" 
018" 
070" 
002" 
0  2  3" 
ns72002 


/*    list 
char 


of 

*c 


county    item   names    for    the    user    */ 

itmnames    [num_cnty    items] 

{"Tot    Pop",     "Pop    <    Age    15",     "Pop    >    Aqe    65",       Poo 
Density",    "Med    Fam    Inc',    "1970    Births',      1970 
Deaths",    "Mean    Income",    "AM    Stations",    " FM 
Stations",    "TV   Stations",    "Interstate",    "US 


Highways" ,    "Sales   Tax 
"Polluters" }     ; 


Tax    Rate1 


"S02    Emission" 


/*    list    of   county    item    names    for    janus    */ 

char  *c_j_itm  names    [numcnty   items] 

T"var201"  ,    "var202",    "var204",    ,"var216'",    "var224 
"birth70",    "death70",    "income69",    "amradio", 
"fmradio",    "tv",    "tra256",    "tra257",    "tax235", 
"tax245",    "so2emis",    "nopollut"}     ; 


74 


APPENDIX  C 
Front-End  Support  Software 
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activate 

Description  :   Every  button  in  the  input  list  of  buttons  is 

activated.  This  includes  displaying  the  button  on  the 
screen  and  marking  its  entry  in  the  button  table  as 
active  . 

Calling  Sequence  :   activate  (number,  button  list) 

1.  number       Number  of  buttons  to  be  activated. 

2.  button  list  Array  of  pointers  into  the  button  definition 

table.   Contains  pointers  to  the  entries  for  the 
buttons  which  are  to  be  activated. 


add  command 

Description  :   The  characteristics  of  a  button  are  entered  into 
the  button  definition  table.   A  pointer  to  this  entry  is 
returned  to  the  calling  procedure.   This  pointer  is  used 
by  other  button-handling  routines  to  reference  this 
button.   The  button  is  not  displayed  and  is  initially 
inactive . 

Calling  Sequence  :   new  button  pointer  =  add  command 

(button_label ,  xposition,  y  position,  x  size,  y  size, 
internal  tag) 

i3 .   new  button  pointer   Pointer  to  the  table  entry  for  the  newly 

created  button.   This  pointer  is  passed  to  other 
button  handling  routines  to  access  this  button. 

1.  button_label        Character  string  to  be  used  to  label  the 

button  when  it  is  displayed. 

2.  x  position,  y  position      The  co-ordinates  on  a  16  x  16 

touch  grid  of  the  lower  left  corner  of  the 
button . 

3.  x  size,  y  size      The  dimensions,  in  touch  grid  units,  of 

the  button. 

4.  internal  tag        Number  to  be  associated  with  the  button. 

This  tag  is  used  to  communicate  to  other 
procedures  which  button  was  touched  by  the  user. 
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bar  graph 

Description  :   The  input  data  element  values  are  displayed  as  a 
bar  graph.  The  values  are  displayed  as  horizontal  bars 
labeled  on  the  left  with  the  element  name  and  on  the 
right  by  the  numeric  value  of  the  element.   The  bars  are 
scaled  so  that  the  smallest  element  value  becomes 
relative  zero  and  the  bar  for  the  largest  value  fills  the 
specified  area,  leaving  room  for  labels.   All  other 
values  are  scaled  linearly  between  these  two  values. 
Elements  with  values  which  inidcate  that  they  are 
"missing  data'  are  displayed  as  a  single  asterisk  instead 
of  as  a  bar . 

Calling  Sequence  :   bar  graph  (origin  x,  oriqin  y,  size  x, 

size  y,  number  values,  element  labels,  element  values, 
title) 

1.  origin  x,  origin  y   The  co-ordinates,  on  a  64  x  32  character 

area  grid,  of  the  lower  left  corner  of  the  scace 
to  be  occupied  bv  the  graph.   Space  0  of  line  0 
is  in  the  lower  left  corner  of  the  screen. 

2.  size  x,  size j      The  size,  in  character  spaces,  of  the 

area  to  be  occupied  by  the  graph. 

Number  of  element  values  to  be  displayed. 

Array  of  pointers  to  character  strings  to 

to  label  the  bars  of  the  graph. 

Array  of  values  to  be  representated  as 

the  graph. 

to  a  character  string  to  be  used  to  label 
the  entire  graph. 


3. 

number    values 

4. 

element   labels 

be    used 

5. 

element   values 

bars  on 

6. 

title                  Pointer 

close 

Description  :   Used  to  relinquish  control  of  an  owned  device. 

Calling  Sequence  :   close  (device  id,  return  status) 

1.  device  id    Internal  identifier  of  the  device  to  be  closed. 

2.  return  status       Pointer  to  a  return  status  word.   Used  to 

indicate  the  success  of  type  of  failure  to  the 
calling  procedure. 
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clr  line 

Description  :   Erases  a  specified  number  of  character  lines  on 
the  screen,  and  positions  the  cursor  at  the  left  of  the 
topmost  cleared  line. 

Calling  Seauence  :   clr  line  (number  lines,  too  line  number) 

1.  number  lines        Number  of  lines,  each  one  character  space 

high,  to  be  erased. 

2.  top  line  number      Number  of  the  topmost  line  to  be  erased. 

Line  0  is  at  the  bottom  of  the  screen. 


deactivate 

Description  :  The  table  entry  for  each  button  in  the  input  list 
is  marked  inactive.  The  buttons  are  not  erased  from  the 
screen . 

Calling  Sequence  :   deactivate  (number,  button  list) 

1.  number       Number  of  buttons  to  be  deactivated. 

2.  buttonlist  Array  of  pointers  into  the  button  definition 

table.   Contains  pointers  to  the  entries  for  the 
buttons  which  are  to  be  deactivated. 


del  command 

Description  :   Deletes  a  set  of  buttons  from  the  internal  button 
table.   Takes  a  list  of  pointers  into  the  table  (returned 
by  add  command  when  the  buttons  were  created) ,  and  makes 
those  slots  available. 

Calling  Sequence  :   del  command  (number,  buttonlist) 

1.  number       The  number  of  buttons  to  be  deleted. 

2.  outton  list  Array  of  pointers  into  the  button  definition 

table.   Contains  pointers  to  the  entries  for  the 
buttons  which  are  to  be  deleted. 
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flush 

Description  :   Allows  buffered  input  from  a  device  to  be 
di  scarded . 

Calling  Sequence  :   flush  (device  id,  return  status) 

1.  device  id    Internal  identifier  of  the  device  to  be  flushed. 

2.  return  status       Pointer  to  a  return  status  word.   Used  to 

indicate  the  success  or  type  ot  failure  to  the 
calling  procedure. 


get  command 

Description  :   Reads  a  button  touched  by  the  user.   As  a 

touch-interrupt  occurs,  the  co-ordinates  of  the  touch  are 
checked  to  find  which  (if  any)  active  button  encompasses 
the  area  hit.   If  such  a  button  is  found,  the  tag  of  that 
button  is  returned  to  the  caller.   If  not,  the  touch  is 
ignored,  and  the  routine  waits  for  the  next  hit.   This 
routine  handles  flashing  a  touched  button. 

Calling  Sequence  :   getcommand  (touch  panel  id) 

1.   touch_panel  id      Internal  identifier  for  the  touch  panel. 

Used  to  read  the  co-ordinates  of  the  touch. 
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get  ianus  values 

Description  :   Retrieves  an  item  from  the  host  system.   Uses  the 
Janus  names  for  the  data  base  and  the  item  to  formulate  a 
request  for  data  to  the  host.   It  all  is  well,  software 
at  the  host  will  ship  back  a  data  item  in  response. 
After  sending  out  the  request,  get  janus  values  reads 
from  the  phone  line,  and  interprets  the  incoming  data  as 
an  item.   If  the  data  is  determined  to  be  in  valid  data 
item  format,  the  item  values  are  converted  intp  PDP11 
internal  format  and  stored  in  the  indicated  memory  slot. 

A  return  status  word  is  set  according  to  : 

0  :   all  went  well 

1  :   host  went  down  before  any  data  was 

tr  ansmi  tted 

2  :       host    went   down    during    transmition 

3  :      garbled    transmition 

Calling    Sequence    :      get    janus    values    (phone    id,    data    base, 
item_janus_name ,    memoryslot    address,    size    of    item, 
return    status) 

1.  phone    id  Internal    device    identifier    of    the    phone. 

2.  database        The    Janus    name    of    the   data    base    from    which    to   get 

the    item.       This    is    the    same    as    the    county   name 
for    county   data    bases,    and    is    the    string 
"Illinois"    for    the    state   data    base. 

3.  iteir  janus   name  The    Janus    name    for    the   desired    item. 

4.  nemoryslot    address    Pointer    to    the    beginning    of    the   memorv 

slot    where    the   new   data    item    is    to    be    put. 

5.  size    of    item  Number    of    elements    in    the    item.       Used    to 

make    check    for    possibly   garbled    transmition. 

6.  return    status  Pointer    to    a   return    status   word.      Used    to 

indicate    the    success   or    type    of    failure    to    the 
calling    procedure. 
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get  touch 

Descritpion  :   Formats  a  list  of  labels  and  button  tags  into 

buttons,  and  allows  the  user  to  choose  up  to  a  specified 
number  of  them.   The  buttons  are  displayed  centerd  as  a 
group  on  the  screen,  with  Cancel  and  Continue  buttons  in 
the  lower  left  and  right  corners.   An  explanitory  message 
is  dispalyed  near  the  bottom  of  the  screen. 

Three  actions  are  taken  when  the  user  touches  a  button. 
The  tag  of  that  button  is  added  to  the  list  of  touched 
buttons  to  be  passed  back  to  the  caller.   The  button  is 
marked  by  a  small  box  in  the  lower  right  corner  to 
signify  that  the  button  has  been  chosen.   And  the  user 
message  is  updated.   Since  this  message  is  often  of  the 
form  "Choose  <n>',  the  value  of  n  is  updated  after  every 
touch  to  reflect  the  number  of  choices  left. 

gettouch  will  only  allow  the  user  to  pick  up  to  a 
specified  number  of  buttons.   After  this  number  of 
buttons  has  been  chosen,  the  message  is  changed  to   Hit 
Proceed  to  continue."   If  more  buttons  are  chosen  after 
this  time,  the  initially  chosen  buttons  are  removed  from 
the  list  and  their  marking  boxes  are  erased. 

A  selected  button  can  be  "un-selected   by  touching  it 
again.   A  button  is  counted  as  hit  iff  it  was  touched  1 
mod  2  times. 

The  current  command  can  be  aborted  at  any  time  by 
touching  the  Cancel  button. 

Before  get_touch  returns,  it  clears  the  screen  and 
removes  all  the  buttons  it  created. 

Calling  Sequence  :   number  chosen  =  get  touch  (touch  panel  id, 
button  labels ,  button  tags,  chosen  button  list, 
number  buttons,  message,  maximum  number  to  be  chosen) 

0.  number  chosen       The  number  of  buttons  chosen  by  the  user. 

If  the  Cancel  button  was  hit,  then  this  value  is 
-1. 

1.  touch  panel  id      The  internal  identifier  for  the  touch 

panel.   Used  to  pass  to  get  touch. 

2.  button  labels       List  of  labels  to  associate  with  the 

buttons  which  are  created. 

3.  button  tags  List  of  internal  tags  to  be  associated  with  the 

buttons . 

4.  chosen  button  list   Pointer  to  the  array  where  the  caller 

wants  the  tags  for  the  chosen  buttons  to  be 
stored . 

5.  number  buttons      The  number  of  buttons  to  be  created. 

6.  maximum  number  to  be  chosen  The  maximum  number  of  buttons 

which  the  user  is  to  be  allowed  to  chose. 
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list  1th 

ascription  :   Determines  the  length  of  a  list  of  character 
strings.   Given  the  maximum  number  of  strings  in  the 
list,  the  procedure  scans  the  array  of  pointers  to 
character  strings  and  returns  the  index  of  the  first  null 
pointer . 


Calling  Sequence 
0.   length 


length  =  list  1th  (pointer  array,  array  size) 


Number  of  character  strings  in  the  list,  up  to 
the  maximum  (array  size) 

1.  pointer  array       Array  of  pointers  to  character  strings. 

2.  array  size   Size  ot  array  —  maximum  possible  size  of  list. 


lite    oox 

Description    :       Lights   or    erases    all    the    dots    inside    a    button. 

Calling    Sequence    :      litebox    (button    pointer,    mode) 

1.  buttonpo inter  Pointer    into    the    button    definition    table 

of    the   desired    button.       Used    to   determined    the 
placement    and    size    of    the    button. 

2,  mode  Determines    whether    the    area    is    lit   or    erased.       1 

for    light,    0    for    erase. 


map 

Description  :   Displays  an  Illinois  data  item  as  a  shaded  map. 
Draws  an  outline  map  of  the  northern  29  counties  of  the 
state  of  Illinois,  then  shades  the  counties  according  to 
the  value  of  the  data  item  for  each  county.   The  map  is 
labeled  with  the  item  name  under  the  map,  and  the  shades 
are  explained  via  a  legend  at  the  bottom  of  the  display. 


map  (number  shades,  item  values,  item  size. 


Number  of  different  shades  to  use  on  the 


Calling  Sequence  : 
item  name) 

1.  number  shades 

map.   Must  be  between  1  and  7. 

2.  item  values  Pointer  to  the  array  of  values  for  the  item  to  be 

displayed . 

3.  item    size        Number    of   values    in    the    item. 

4.  itemname         Pointer    to    the   name    of    the   data    item.       Used    to 

label    the  map. 
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open 

Description  :   Allows  a  process  to  acquire  possession  of  a 
device . 

Calling  Sequence  :   device  id  =  open  (device  code,  block  flag. 
return  status) 

0.  device  id    Internal  logical  identifier  to  be  associated  with 

this  device.   Used  to  communicate  with  other 
procedures  which  need  a  device  id. 

1.  device  code  System  wide  code  number  associated  with  the 

device . 

2.  block  flag   If  this  value  is  non-zero,  the  open  will  block 

(wait)  until  the  reouested  device  is  available. 

3.  return  status       Pointer  to  a  return  status  word.   Used  to 

indicate  the  success  or  type  of  failure  to  the 
calling  procedure. 


open  ph 

Description  :   Special  opening  routine  for  the  phone  line. 

Includes  extra  code  to  handle  problems  associated  with 
synchronizing  the  request  to  open  with  the  physical 
process  of  establishing  a  carrier  signal  on  the  ohone 
line  . 

Calling  Sequence  :   phone  id  =  open_ph  () 

0.   phone  id     Internal  logical  identifer  of  the  phone  line. 


pr    help 

Description    :      Prints    an    explanitory   paragraph    about    one    of    the 

commands   of    the    front-end    system.       Using    the    file   name   of 
the    help    text    on    the    host,    pr    help    formulates    a    request 
to    the    host.       In    response.,    the    host    ships    the    requested 
file.      pr    help    then    strips   of    the    leading    information    and 
prints    everything    up    to    the    trailer   on    the    screen. 

Calling    Sequence    :      pr    help    (phone    id,    help    file) 

1.  phoneid  Internal    identifier    of    the    phone    line. 

2.  help    file        Pointer    to    the    character    string    which    spells    the 

name    of    the    help   file    on    the    host    svstem. 
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pr  in  1 f 

Description  :   Prints  one  constant  string  with  an  arbitrary  number 

of  parameters.   Parameter  replacement  in  the  constant  string 
is  signified  by   %x"  ,  where  x  is  one  of  c  (character),  s 
(character  string)  ,  o  (octal)  ,  d  (decimal)  ,  or  1 
(unsigned  decimal).  The  starting  position  of  the  printing 
is  determined  by  the  position  of  the  "cursor".   The 
cursor  is  moved  by  the  action  of  printing  each  character, 
and  can  be  set  explicitely  by  the  routine  set  cursor. 
(The  position  of  the  cursor  is  remembered  internally  — 
it  is  not  displayed.) 

The  screen  contains  32  character  lines  of  64  spaces  each. 
Character  0  of  line  0  is  in  the  lower  left  corner  of  the 
screen . 

Calling  Sequence  :   printf  (format,  pi,  p2,  p3,  ...  ) 

1.  format       Pointer  to  the  constant  format  string. 

2.  pi,  p2,  p3,  ...      Parameters  to  the  format  string. 


read 

Description    :      Handles    reading    from    an    arbitrary   device. 

Calling    Sequence    :      read    (device    id,    buffer    pointer, 
buffer    length,    r eturnstatus) 

1.  device    id         Internal    identifier    of    the   device    to   be    read 

f  rom . 

2.  buffer  pointer       Pointer  to  the  buffer  where  the  input  is 

to  be  placed . 

3.  buffer  length       Size  of  the  buffer  —  the  maximum  number 

of  characters  to  be  read. 

4.  return  status       Pointer  to  a  return  status  word.   Used  to 

indicate  the  success  or  type  of  failure  to  the 
calling  procedure. 


screen  clear 

Description  :   Erases  all  the  dots  on  the  screen 

Calling  Sequence  :   screen  clear  () 
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set    cursor 

Description    :       Positions    the    cursor    on    the    screen.       Used    in 
connection   with    printf. 

Calling    Sequence    :      set    cursor    (x,    y) 

1.  x  Horizontal    co-ordinate   of    the   new   cursor 

position.      Each   line    has   64    spaces,    with    space   0 
being    on    the   left. 

2.  y  Vertical    co-ordinate   of    the   new  cursor    position. 

The    screen    has    32    lines,    with    line    0    being    on    the 
bottom . 


str_lth 

Description    :       Determines   the    length   of    a    (null-terminated) 
character    string. 

Calling    Sequence    :      length    =    str    1th    (string) 

0.  length  Length   of    the    string. 

1.  string  Pointer    to    the   character    string. 


table 

Description    :       Displays    up    to    3    data    items    in    a    tabular    format. 
The    table    is   centered    on    the    screen.      The    items    are 
presented    in    columns,    separated    by   line.      The    columns    are 
labeled    at    the    top   with    the    item   name,    and    on    the    left 
side    of    the    table   with    the   element    names.    Every    third 
line    is    underlined    with    a  dotted    line    for    readability. 

Calling    Sequence    :      table    (itemnames,    number    items, 
element   names,    item    size,    item   values) 

1.  item    names      Array   of   pointers    to    the   names   of    the    items   to    be 

displayed.       Used    to    label    columns. 

2.  number    items  Number    of    items    to    be   displayed. 

3.  element   names  Array   of    pointers    to    the   names   of    the 

elements    in    these    items.       Used    to    label    rows. 

4.  item    size        Number    of    elements    in    the    items. 

5.  item'values   Array   of    pointers    to    the   values    for    the    items    to 

be   displayed . 


85 


terminal 

Description  :   Simulates  an  ordinary  ASCII  terminal.   Reads  from 
both  the  keyboard  and  the  phone  line.   Input  from  the 
keyboard  is  shipped  down  the  phone  line  and  echoed  on  the 
screen.   Input  from  the  ohone  is  printed  on  the  screen. 
This  routine  handles  character  and  line  delete  and 
prevents  characters  from  the  phone  from  being 
interspursed  with  text  from  the  keyboard. 

Calling  Sequence  :   system  status  =  terminal  (phone  id  address) 

0.  system  status       Return  value  is  1  if  the  host  system  is 

available,  and  0  otherwise. 

1.  phoneid  address     Pointer  to  the  internal  identifier  of  the 

phone  line. 


wr  ite 

Description  :   Handles  writing  to  an  arbitrary  device. 

Calling  Sequence  :   write  (device  id,  buffer  pointer, 
buf f er _length ,  return  status) 

1.  device  id    Internal  identifier  of  the  device  to  be  written 

to  . 

2.  buffer  pointer       Pointer  to  the  beginning  of  the  character 

string  to  be  written. 

3.  buffer  length       Number  of  characters  to  be  written, 

including  the  terminating  null. 

4.  return  status       Pointer  to  a  return  status  word.   Used  to 

indicate  the  success  or  type  of  failure  to  the 
calling  procedure. 
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